home *** CD-ROM | disk | FTP | other *** search
/ Mac Easy 2010 May / Mac Life Ubuntu.iso / casper / filesystem.squashfs / usr / share / python-support / python-xdg / xdg / IniFile.py < prev    next >
Encoding:
Python Source  |  2009-03-04  |  9.4 KB  |  395 lines
  1. """
  2. Base Class for DesktopEntry, IconTheme and IconData
  3. """
  4.  
  5. import re, os.path, codecs
  6. from Exceptions import *
  7. import xdg.Locale
  8. import gettext
  9.  
  10. class IniFile:
  11.     defaultGroup = ''
  12.     fileExtension = ''
  13.  
  14.     filename = ''
  15.     gettext_domain = None
  16.  
  17.     tainted = False
  18.  
  19.     def __init__(self, filename=None):
  20.         self.content = dict()
  21.         if filename:
  22.             self.parse(filename)
  23.  
  24.     def parse(self, filename, headers):
  25.         # for performance reasons
  26.         content = self.content
  27.  
  28.         if not os.path.isfile(filename):
  29.             raise ParsingError("File not found", filename)
  30.  
  31.         # parse file
  32.         try:
  33.             file(filename, 'r')
  34.         except IOError:
  35.             return
  36.  
  37.         for line in file(filename,'r'):
  38.             line = line.strip()
  39.             # empty line
  40.             if not line:
  41.                 continue
  42.             # comment
  43.             elif line[0] == '#':
  44.                 continue
  45.             # new group
  46.             elif line[0] == '[':
  47.                 currentGroup = line.lstrip("[").rstrip("]")
  48.                 if debug and self.hasGroup(currentGroup):
  49.                     raise DuplicateGroupError(currentGroup, filename)
  50.                 else:
  51.                     content[currentGroup] = {}
  52.             # key
  53.             else:
  54.                 index = line.find("=")
  55.                 key = line[0:index].strip()
  56.                 value = line[index+1:].strip()
  57.                 try:
  58.                     if debug and self.hasKey(key, currentGroup):
  59.                         raise DuplicateKeyError(key, currentGroup, filename)
  60.                     else:
  61.                         content[currentGroup][key] = value
  62.                 except (IndexError, UnboundLocalError):
  63.                     raise ParsingError("[%s]-Header missing" % headers[0], filename)
  64.  
  65.         self.filename = filename
  66.         self.tainted = False
  67.  
  68.         # check header
  69.         for header in headers:
  70.             if content.has_key(header):
  71.                 self.defaultGroup = header
  72.                 break
  73.         else:
  74.             raise ParsingError("[%s]-Header missing" % headers[0], filename)
  75.  
  76.         # check for gettext domain
  77.                 e = self.content.get('Desktop Entry', {})
  78.                 self.gettext_domain = e.get('X-GNOME-Gettext-Domain',
  79.                         e.get('X-Ubuntu-Gettext-Domain', None))
  80.  
  81.     # start stuff to access the keys
  82.     def get(self, key, group=None, locale=False, type="string", list=False):
  83.         # set default group
  84.         if not group:
  85.             group = self.defaultGroup
  86.  
  87.         # return key (with locale)
  88.         if self.content.has_key(group) and self.content[group].has_key(key):
  89.             if locale:
  90.                                 key = self.__addLocale(key, group)
  91.                                 if key.endswith(']') or not self.gettext_domain:
  92.                                         # inline translations
  93.                                         value = self.content[group][key]
  94.                                 else:
  95.                                         value = gettext.dgettext(self.gettext_domain, self.content[group][key])
  96.             else:
  97.                 value = self.content[group][key]
  98.         else:
  99.             if debug:
  100.                 if not self.content.has_key(group):
  101.                     raise NoGroupError(group, self.filename)
  102.                 elif not self.content[group].has_key(key):
  103.                     raise NoKeyError(key, group, self.filename)
  104.             else:
  105.                 value = ""
  106.  
  107.         if list == True:
  108.             values = self.getList(value)
  109.             result = []
  110.         else:
  111.             values = [value]
  112.  
  113.         for value in values:
  114.             if type == "string" and locale == True:
  115.                 value = value.decode("utf-8", "ignore")
  116.             elif type == "boolean":
  117.                 value = self.__getBoolean(value)
  118.             elif type == "integer":
  119.                 try:
  120.                     value = int(value)
  121.                 except ValueError:
  122.                     value = 0
  123.             elif type == "numeric":
  124.                 try:
  125.                     value = float(value)
  126.                 except ValueError:
  127.                     value = 0.0
  128.             elif type == "regex":
  129.                 value = re.compile(value)
  130.             elif type == "point":
  131.                 value = value.split(",")
  132.  
  133.             if list == True:
  134.                 result.append(value)
  135.             else:
  136.                 result = value
  137.  
  138.         return result
  139.     # end stuff to access the keys
  140.  
  141.     # start subget
  142.     def getList(self, string):
  143.         if re.search(r"(?<!\\)\;", string):
  144.             list = re.split(r"(?<!\\);", string)
  145.         elif re.search(r"(?<!\\)\|", string):
  146.             list = re.split(r"(?<!\\)\|", string)
  147.         elif re.search(r"(?<!\\),", string):
  148.             list = re.split(r"(?<!\\),", string)
  149.         else:
  150.             list = [string]
  151.         if list[-1] == "":
  152.             list.pop()
  153.         return list
  154.  
  155.     def __getBoolean(self, boolean):
  156.         if boolean == 1 or boolean == "true" or boolean == "True":
  157.             return True
  158.         elif boolean == 0 or boolean == "false" or boolean == "False":
  159.             return False
  160.         return False
  161.     # end subget
  162.  
  163.     def __addLocale(self, key, group=None):
  164.         "add locale to key according the current lc_messages"
  165.         # set default group
  166.         if not group:
  167.             group = self.defaultGroup
  168.  
  169.         for lang in xdg.Locale.langs:
  170.             if self.content[group].has_key(key+'['+lang+']'):
  171.                 return key+'['+lang+']'
  172.  
  173.         return key
  174.  
  175.     # start validation stuff
  176.     def validate(self, report="All"):
  177.         "validate ... report = All / Warnings / Errors"
  178.  
  179.         self.warnings = []
  180.         self.errors = []
  181.  
  182.         # get file extension
  183.         self.fileExtension = os.path.splitext(self.filename)[1]
  184.  
  185.         # overwrite this for own checkings
  186.         self.checkExtras()
  187.  
  188.         # check all keys
  189.         for group in self.content:
  190.             self.checkGroup(group)
  191.             for key in self.content[group]:
  192.                 self.checkKey(key, self.content[group][key], group)
  193.                 # check if value is empty
  194.                 if self.content[group][key] == "":
  195.                     self.warnings.append("Value of Key '%s' is empty" % key)
  196.  
  197.         # raise Warnings / Errors
  198.         msg = ""
  199.  
  200.         if report == "All" or report == "Warnings":
  201.             for line in self.warnings:
  202.                 msg += "\n- " + line
  203.  
  204.         if report == "All" or report == "Errors":
  205.             for line in self.errors:
  206.                 msg += "\n- " + line
  207.  
  208.         if msg:
  209.             raise ValidationError(msg, self.filename)
  210.  
  211.     # check if group header is valid
  212.     def checkGroup(self, group):
  213.         pass
  214.  
  215.     # check if key is valid
  216.     def checkKey(self, key, value, group):
  217.         pass
  218.  
  219.     # check random stuff
  220.     def checkValue(self, key, value, type="string", list=False):
  221.         if list == True:
  222.             values = self.getList(value)
  223.         else:
  224.             values = [value]
  225.  
  226.         for value in values:
  227.             if type == "string":
  228.                 code = self.checkString(value)
  229.             elif type == "boolean":
  230.                 code = self.checkBoolean(value)
  231.             elif type == "number":
  232.                 code = self.checkNumber(value)
  233.             elif type == "integer":
  234.                 code = self.checkInteger(value)
  235.             elif type == "regex":
  236.                 code = self.checkRegex(value)
  237.             elif type == "point":
  238.                 code = self.checkPoint(value)
  239.             if code == 1:
  240.                 self.errors.append("'%s' is not a valid %s" % (value, type))
  241.             elif code == 2:
  242.                 self.warnings.append("Value of key '%s' is deprecated" % key)
  243.  
  244.     def checkExtras(self):
  245.         pass
  246.  
  247.     def checkBoolean(self, value):
  248.         # 1 or 0 : deprecated
  249.         if (value == "1" or value == "0"):
  250.             return 2
  251.         # true or false: ok
  252.         elif not (value == "true" or value == "false"):
  253.             return 1
  254.  
  255.     def checkNumber(self, value):
  256.         # float() ValueError
  257.         try:
  258.             float(value)
  259.         except:
  260.             return 1
  261.  
  262.     def checkInteger(self, value):
  263.         # int() ValueError
  264.         try:
  265.             int(value)
  266.         except:
  267.             return 1
  268.  
  269.     def checkPoint(self, value):
  270.         if not re.match("^[0-9]+,[0-9]+$", value):
  271.             return 1
  272.  
  273.     def checkString(self, value):
  274.         # convert to ascii
  275.         if not value.decode("utf-8", "ignore").encode("ascii", 'ignore') == value:
  276.             return 1
  277.  
  278.     def checkRegex(self, value):
  279.         try:
  280.             re.compile(value)
  281.         except:
  282.             return 1
  283.  
  284.     # write support
  285.     def write(self, filename=None):
  286.         if not filename and not self.filename:
  287.             raise ParsingError("File not found", "")
  288.  
  289.         if filename:
  290.             self.filename = filename
  291.         else:
  292.             filename = self.filename
  293.  
  294.         if not os.path.isdir(os.path.dirname(filename)):
  295.             os.makedirs(os.path.dirname(filename))
  296.  
  297.         fp = codecs.open(filename, 'w')
  298.         if self.defaultGroup:
  299.             fp.write("[%s]\n" % self.defaultGroup)
  300.             for (key, value) in self.content[self.defaultGroup].items():
  301.                 fp.write("%s=%s\n" % (key, value))
  302.             fp.write("\n")
  303.         for (name, group) in self.content.items():
  304.             if name != self.defaultGroup:
  305.                 fp.write("[%s]\n" % name)
  306.                 for (key, value) in group.items():
  307.                     fp.write("%s=%s\n" % (key, value))
  308.                 fp.write("\n")
  309.         self.tainted = False
  310.  
  311.     def set(self, key, value, group=None, locale=False):
  312.         # set default group
  313.         if not group:
  314.             group = self.defaultGroup
  315.  
  316.         if locale == True and len(xdg.Locale.langs) > 0:
  317.             key = key + "[" + xdg.Locale.langs[0] + "]"
  318.  
  319.         try:
  320.             if isinstance(value, unicode):
  321.                 self.content[group][key] = value.encode("utf-8", "ignore")
  322.             else:
  323.                 self.content[group][key] = value
  324.         except KeyError:
  325.             raise NoGroupError(group, self.filename)
  326.             
  327.         self.tainted = (value == self.get(key, group))
  328.  
  329.     def addGroup(self, group):
  330.         if self.hasGroup(group):
  331.             if debug:
  332.                 raise DuplicateGroupError(group, self.filename)
  333.             else:
  334.                 pass
  335.         else:
  336.             self.content[group] = {}
  337.             self.tainted = True
  338.  
  339.     def removeGroup(self, group):
  340.         existed = group in self.content
  341.         if existed:
  342.             del self.content[group]
  343.             self.tainted = True
  344.         else:
  345.             if debug:
  346.                 raise NoGroupError(group, self.filename)
  347.         return existed
  348.  
  349.     def removeKey(self, key, group=None, locales=True):
  350.         # set default group
  351.         if not group:
  352.             group = self.defaultGroup
  353.  
  354.         try:
  355.             if locales:
  356.                 for (name, value) in self.content[group].items():
  357.                     if re.match("^" + key + xdg.Locale.regex + "$", name) and name != key:
  358.                         value = self.content[group][name]
  359.                         del self.content[group][name]
  360.             value = self.content[group][key]
  361.             del self.content[group][key]
  362.             self.tainted = True
  363.             return value
  364.         except KeyError, e:
  365.             if debug:
  366.                 if e == group:
  367.                     raise NoGroupError(group, self.filename)
  368.                 else:
  369.                     raise NoKeyError(key, group, self.filename)
  370.             else:
  371.                 return ""
  372.  
  373.     # misc
  374.     def groups(self):
  375.         return self.content.keys()
  376.  
  377.     def hasGroup(self, group):
  378.         if self.content.has_key(group):
  379.             return True
  380.         else:
  381.             return False
  382.  
  383.     def hasKey(self, key, group=None):
  384.         # set default group
  385.         if not group:
  386.             group = self.defaultGroup
  387.  
  388.         if self.content[group].has_key(key):
  389.             return True
  390.         else:
  391.             return False
  392.  
  393.     def getFileName(self):
  394.         return self.filename
  395.